Publisher Platinum

home *** CD-ROM | disk | FTP | other *** search

/ Publisher Platinum / Publisher Platinum.iso / clipart / utils / vjpeg1b / vjpeg.doc < prev next >

Wrap

Text File | 1993-04-30 | 12.3 KB | 317 lines

Welcome to ViewJPEG Version 1.0b. (C) 1992 Danny Hawrysio ViewJPEG is a viewer for JFIF standard JPEG files. Specifically what ViewJPEG does is: * displays in text mode a list of the JPEG files in the selected directory * views a JFIF JPEG in 256 colors upon selection * writes GIF file upon command * displays JPEG files in a slideshow mode ViewJPEG was written in 'C' and supports the 256 color modes in VGA & SuperVGA graphics cards only, ViewJPEG does not support 16 color modes. Two executable files, one for 80286 computers with math coprocessors (VJPEG.EXE) & one for 8088 computers without math coprocessors (VJPEGNOM.EXE) are included. Both versions however needs at least 1 meg of extended, and up 2+ megs to work at optimum capacity. Now for ViewJPEG's price: Free. If you feel the need to contact me below is my address and places to reach me. Danny Hawrysio 212 Main St. Toronto, Ont. Canada M4E 2W1 Voice (416) 693-8917 USENET E-Mail Danny.Hawrysio@canrem.com or ViewJPEG's offical release site: Digtal Pixel BBS (416) 298-1487 You may distribute ViewJPEG if you keep the entire package together, unchanged as indicated in FILELIST.TXT, including the following license explanation. ViewJPEG hereby disclaims any warranties relating to this software, whether express or implied. ViewJPEG will not be liable for any special, incidental, consequential, indirect or similar damages due to loss of data or any other reason. ViewJPEG is the sole copyright of Danny Hawrysio. Before starting ViewJPEG put the files in a directory of your choice and execute JCONFIG.EXE which well ask you to selected the graphics that work with your system and write it to disk. ViewJPEG uses a generic SuperVGA driver which should work with most SuperVGA graphic cards and a graphics screen should pop up in JCONFIG.EXE with a line diagonally across the screen after the resolution has been selected, if a graphic screen does not appear in JCONFIG.EXE then the graphic mode defiantly will not work in ViewJPEG. If you do not have SuperVGA or JCONFIG lists modes your card does not support, do not, I repeat do not select the modes, it may produce unpredictable results. One more note on the SuperVGA driver, since I don't have a 1024x768x256 mode on my card it has not been tested. After JCONFIG has written the configure file in the directory you have chosen, ViewJPEG will then run from any directory as long as you have it's installed directory in the PATH command or you call ViewJPEG directly from that directory. While ViewJPEG does not require command line arguments, if a path to a directory is included upon execution ViewJPEG will scan that directory for JPEG files. The command key functions under the Main Menu are as follows: Key Function --- ----------- Space bar Toggles tag/untag for slideshow Enter Read JPEG F2 Start slideshow F3 Gets JPEG dimensions F4 Toggle grayscale/color F5 Change to next lowest resolution F6 Change to next highest resolution F8 Set Pause limit F9 Change directory F10 Toggle between 1 or 2 color pass ESC Quits program Alt-X Deletes file in text mode Arrow Key Function ---------- ------------ Down Moves selection bar one down Up Moves selection bar one up Right Moves selection bar one to the right Left Moves selection bar to the left These functions are accessed by pressing the key equivalent on the keyboard. The command key functions while a JPEG file is viewed: Key Function --- ----------- F9 Darkens screen RGBs one notch F10 Brightens screen RGBs one notch w or W Writes a GIF file Alt-X Deletes file in graphics mode Now onto the the individual functions: Key Function --- ----------- Space bar Toggle tag/untag for slideshow Pressing the space bar on a file name currently highlighted will change it to a inverse purple color indicating to the program that when the slideshow function is pressed (F2) that file along with any other file(s) selected will be displayed in a slideshow manner. If the file name is already inverse purple then pressing the space bar over it will deselect the file for the slideshow. Key Function --- ----------- Enter Read JPEG By pressing the Enter key the current chosen file will be displayed at the present graphics mode selected (see function F5 for more about selecting the graphics mode), until a key other then F9, F10, w or W is pressed. Key Function --- ----------- F2 Start slideshow By pressing the F2 key the program displays all the file names that's inverted in purple in the same order as the names are in the text display. The first file may take sometime to display depending on the size and the image will be shown in the resolution it will most fit, after that the image will be displayed while the next file is read. The next file will be displayed after it's been read or until the time pause limit has been passed, which ever is the longest. The function will continue to display the files until a key is pressed. This function works best when you have a lot of extended memory, which in most cases it will use to store the image being read while another is displayed. If you do not have 2 megs or more of extended memory it may display the file as it is being read. Key Function --- ----------- F3 Gets JPEG dimensions By pressing the F3 key the X & Y resolutions of the current file highlighted will be displayed at the bottom left hand of the screen. The higher the resolution the longer the file will take to be read. Key Function --- ----------- F4 Toggle grayscale/color Pressing F4 key will toggle between the image being displayed in color or in grayscale. The default is color, when the program is in grayscale mode it will be noted in the top right corner when in the text mode, but when in color mode the top right corner will be blank. Supposedly grayscale is faster then color. Key Function --- ----------- F5 Change to next lowest resolution Shown at the second text row is the resolutions available to display at, e.g. : 320x200 640x400 640x480 800x600 and whatever mode is colored green, that will be the mode the JPEG file is viewed in. The default resolution is the highest. Pressing the F5 key will select the next lowest resolution as the graphics mode that will be used by the Enter function. Key Function --- ----------- F6 Change to next highest resolution Pressing the F6 key will select the next highest resolution as the graphics mode that will be used by the Enter function. Key Function --- ----------- F8 Set Pause limit When in slideshow mode the program will pause so as to allow to time enough to view the image. By pressing the F8 key one can redefine the number of seconds the image must be displayed (see function F2 for more info). The default is 10 seconds. Key Function --- ----------- F9 Change directory When the F9 key is pressed a prompt will appear on the bottom left corner asking for a directory path, which it will scan for JPEG files then list on the screen. Key Function --- ----------- F10 Toggle between 1 or 2 color pass Pressing the F10 key will toggle whether the JPEG files will be read in 1 or 2 passes. A one pass read will be quicker and will require less memory then pass 2, but will also be of less quality then pass 2. The current pass number will be indicated on the top in the middle of the screen. Pass 1 is the default. Key Function --- ----------- ESC Quits program Pressing the ESC key will end the program and return to the dos command line. Key Function --- ----------- Alt-X Deletes file in text mode By pressing both Alt & X in text mode, a prompt will appear at the bottom left screen asking: Delete File (Y/N)?. Pressing Y or y then will cause the file to be erased from the disk. Pressing N or n will return you to the program. Arrow Key Function ---------- ------------ Down Moves selection bar one down In order for ViewJPEG to know what files to show a selection bar is used to determine by the user, with the help of the arrow keys, what files to view. By pressing the down arrow key the next file below is highlighted. Arrow Key Function --------- ------------ Up Moves selection bar one up By pressing the up arrow key the next file above is highlighted. Arrow Key Function --------- ------------ Right Moves selection bar one to the right By pressing the right arrow key the next file to the right is highlighted. Arrow Key Function --------- ------------ Left Moves selection bar to the left By pressing the left arrow key the next file to the left is highlighted. While a JPEG file is viewed in a graphics mode a few command key functions are available: Key Function --- ----------- F9 Darkens screen RGBs one notch Pressing F9 will darken the display screen RGB palette by one. Key Function --- ----------- F10 Brightens screen RGBs one notch Pressing F10 will lighten the display screen RGB palette by one. Key Function --- ----------- w or W Writes a GIF file By pressing w or W the entire current screen will be written to disk as a GIF file along with the current RGB palette and will tell the user when it is finished. Key Function --- ----------- Alt-X Deletes file in graphics mode By pressing both Alt & X in graphics mode, a prompt will appear at the top right screen asking: Delete File (Y/N)?. Pressing Y or y then will cause the file to be erased from the disk. Pressing N or n will return you to the program. JPEG WARNINGS. I will now repeat what every other JPEG program has said before: JPEG is lossy compression format which from the beginning was meant for only for scanned images period. Other kinds of computer graphics, like from raytracers or paint programs, are unsuited for JPEG use and if JPEGed will - 1) Be no smaller then a good lossless graphic format like LZH TIFFs 2) Damage the quality of the images. JPEG is best for personal use rather then for porting graphics non-scanned about and JPEGing some person's computer art then uploading it about is not very nice - how would you like it if someone crumpled up a piece of work you labored weeks or months on? On more thing, avoid JPEGing even a scanned image more then once. With every JPEG a image losses quality JPEGing several times will multiply that amount of loss. Beware of programs that write non-JFIF standard files at default like JPG2GIF.EXE, most JPEG compression programs have a command line switch to select the JFIF standard, in JPG2GIF.EXE's case that switch is -J. BUGS. In order to get ViewJPEG to I had to do some peculiar things which may produce bugs in other systems, although I don't know of any yet, E-mail me if you discover any. FUTURE VERSIONS. There likely may not be a future version since ViewJPEG is free, unless there is something I want to add, so don't inundate me with requests to change things as it is unlikely I will do it (Hell, it's free you know).